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e@ Graphics Guys | Date: February 4, 1978 
From: Dick Shoup | Loc.: Palo Alto 


Subject: Old Software on the Color Video System: Org. PARC/CSL 


This document describes very briefly the capabilities available to a user ai the 
terminal of the color video systein cae for SUPERPAINT, described in another 
memo}. This is not a user manual fer the system but merely a compendium of 
frequently used programs. Its celts not gir to call the collection of separate. 
programs described here a "command language” nor has that been claimed. What 
can be seen here are some of the capabilities” which are available... Most of these 
capebilities have been integrated: into the SUPERPAINT program with a ‘simple tablet 
directed command structure. 


Using these routines requires calling them individually from the DOS exec. by typing 
their names in the usual way {with the usual delay). Thus one might use the 
PAINT pregram to create some subimages, position them using MOVEPA, adjust 
colors using SETCOLOR, and save the result on disk with SAVPA. Subimages might 
then be combined using RESPA and resaved, etc. Tne file format for po oint array 
files is given in the appendix. 


What follows is organized like so: a brief description of the overall system, then 
descriptions of painting, etc. programs, point array pou neS color/value routines, and 
demo and Pea ane programs. 


COLOR GRAPHICS SYSTEM 


The graphics Nova is interfaced to a number of peripherals, notably the picture 
memory (PM) which holds one color digital video. image (480x640 points}, the 
tablet, and the video disk. The PM hardware also includes a 256-color map and 
some special logic - (such as run dtdength encoding and decoding) to aid in. 
manipulating point array images. iar this is under control of the Nova. 


Software existing on the system consists of a large variety of separate programs, 
most of which run under the Nova DOS. These include painting programs, point 
array manipulating routines, spline curve editors, color space manipulators, jaggy 
removal demos, a version of Smalitaik, ete. Most of the recent programs are written 
in BCPL and run with a set of support routines called G06. G0OG software includes © 
routines for reading and writing the PM, reading and writing point array files, 
handling the color space, tablet, etc. | | 7 


‘Throughout this document, a small rectangular area on the tablet frame will he 
referred to as the “pad”. This area is touched with the’ pen to indicate an. escape, a 
default, etc., as described below. Also, some of the programs {ihe more recent ones} 
use the D EFAULT and GO areas marked on the tablet (Uike eee re does}. 
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PAINTING, ETC. PROGRAMS 


PAINT 


Global switches: 


/C 


Local switches: | 


file/P 


file/B - 


NPAINT 


This is the main painting program. It handles the palette, 
the brushes, etc. and has. the area-filling routine within it. 
Brushes and colors are selected by touching them via the 
tablet. To invoke area-filling: touch the desired palette 


color, touch the upper left-hand corner of the screen, touch 


the desired 2ren. 


Causes the “canvas” part of the screen to be cleared 
before executing (normally it is left unchanged). 


Causes file to be used as the palette (default is’ 
STDPALETTE.PA}. Any point array file may be used 
(see SAVPA)} and will be positioned centered on the 
palette area. 


Causes file to be interpreted as the list of brush names 
(see MAKELIST). Brushes are just point array files and 
file is a text file. Default is STDBRUSHES.LI. 


This is a version of PAINT with two pictures into which to 
paint. One has the brushes and palette on the edges like 
PAINT, the other (accessed by touching the pen down on the 
small pad on the tablet frame} is completely free for 
painting. To switch back and forth betwen the two pictures, 
hit the pad again. A smaller palette is used {NPAL.PA) since 
only 16 colors are available in each picture. No area filling 


facility. 


- Global switches: 


| /B 


Specifies that both pictures are to be displayed 
simultaneously. This causes interesting mixing and 
overlay effects in the resuitant color space. 


Local switches: {same as PAINT). 


MAKELIST filename 


This routine creates a text file named filename and puts in it 
a list of the names you type (after the colon prompt). This 
list file (usually with extension .LI} can hold the names of 


- point array files (six or fewer} and can be used as a brush 


list to the PAINT program with /B. E.g. if you create files 
Bl, B2 and B3 with SAVPA, then do: 


MAKELIST BL.LI [carriage return] 
-B1 B2 BS [carriage return] 
PAINT BL.LI/B [carriage return] 
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You will then be able to paint with brushes Bl, B2 and B3.. 


POINT ARRAY MANIPULATING ROUTINES 


SAVPA 


RESPA 


TRANSPA 


MOVEPA 


ZOOMIN 


ZOOMOUT 
REFLECT 


Global switches: 


/T 


Save point array file. This is the main routine for saving 
part or all of the PM contents in a point array file (usually 
extension .PA)}. The desired file name is given in response to 
a TTY prompt. Allows specification of the desired rectangular 
area by indicating two corners and an origin {arbitrary 
positioning point) via the tablet. Default {if pen is touched 
down in DEFAULT area of the tablet) is the whole screen. 


Restore point array file. The desired file name is given in 
response to a TTY prompt. A single point is specified via 
the tablet and the origin point of the PA is placed there. Hf 
the DEFAULT area is touched, then the PA is _ positioned 
where it was when it was saved. : 


Transform (translate, rotate and scale) point array. This 
program does a transformation on a point array from the PM 
and places it back in the PM. There are no switches and the 
parameters are given via tablet and TTY in response to 
prompts on the TTY. This routine is not very smart and can 
only handle PAs which can fit in core. 


Does a simple translate of a point array. You specifiy a 
rectancular area, and origin point and a destination point. 


Using two corner cursors supplied sequentially, an origin for 
the area, and a destination origin for the result, this routine 
scales a@ point array up by a factor of two. You specify a 
rectangular area, an origin for the area, and* a destination 
origin for the result. The default area {indicated by pen 
down on DEFAULT) is the entire screen. | 


Similar to ZOOMIN but shrinks everything by a factor of 2. 


This routine provides a mirror-image reflection about the 0, 
90, 180 or 270 degree axis (specified via the TTY). The 
reflection axis is a line which passes through the center of 
the rectangular area. | 


Allows specification of the point array from the tablet. 
Default (pen down on the pad} is the whole screen. 


COLOR/VALUE ROUTINES 


At each point in the picture memory, a value is stored. A value is an 8 bit 
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number. It is these values that make up a point array. Associated with each of 
the 256 values is a color definition. Color definitions are placed in the color map 
and the PM hardware accesses this map to generate the red, green and blue signals 
which produce the appropriate colors on the screen. 


The hardware also has the capability to replace all occurrences of a given value 
with another given value throughout the PM in one frame time. The following 
three routines use this capability. 


SETVALUE value newvalue ‘This routine causes all occurrences of value to be 
replaced by newvaiue throughout the picture. 


Gicbal switches: 


/T Allows value and newvalue to be specified from the 
tablet via two successive pen downs. 


SWAP This routine exchanges all oceurrences of two values which 
| you specify via the tablet. | 


FLASH | This routine produces an entertaining effect by SWAPing all 

| 7 values sequentially through the value space. : 

ZAP Sets the entire PM to the value given in response to a TTY 
prompt. | 


The following routines manipulate the color definitions in the color map rather than 
the values: 


SETCOLOR This routine allows the user to set the color definition of any 
| value individually. Three slider scales are displayed on the 
screen representing the red, green and blue components of the | 
color. A particular value is first selected via the tablet (by 
touching any point outside the slider area). Then the sliders 
can be moved to alter the color definition of the selected 
value. Ail occurrences of the selected value will be seen to 
change color as the sliders are moved. 


Global switches 
/H The three sliders represent hue, saturation and 
brightness instead of red, green and blue respectively. 
The program does the .appropriate computation to 
transform from HSV space to RGB space. 
/N- | Does not display the sliders but otherwise operates 
identically. | 
SETMTOT filename - This program sets the colormap from the color definitions 
MRF given in the PA file filename. If any of the following 


switches are set, the program sets all 256 color definitions to 
shades of a single hue with high saturation. The hue is 
specified by the switch: 
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Global switches: 
/B | 
/C 
/G 
IM 
ais 
/W 


/Y 


COLORCUBE 


FADE 


CYCOLORS 


Global switches: 


/B 


/V 


Blue. 

Cyan, 

Green. 

Magenta. 

Red. 

White (“grayscale”). 
Yellow. 


If no file name is given and no switch is given, the colormap 
is set to the color definitions which were hardwired inte the 
PM before the caolormap existed. In those days, the 8 bits 
were allocated RRRBGGGB, thus providing 3 bits of red, 3 
bits of green, and 2 bits of blue information. | 


This is an elaborate program for setting the entire color 
space, collectively or individually, to colors of constant 
primary, colors of constant hue, saturation or _ brightness, 
demonstrating simultaneous color perception phenomena, equal 
energy planes, etc. Its operation is controlled entirely from 
the tablet and can best be understood by observing a demo. 


This program allows all the existing color definitions to be 
faded to black (like a conventional video fade}. The y 
coordinate of the tablet is used, full color being near the top 
of the tablet and total black near the bottom. 


This program provides an entertaining effect by shifting all 
the color definitions sequentially through the value space. 


Leaves the background {value 0} unchanged during 
cycling. 


Waits for vertical interval (1/60 second apart) before 
each color map change. . | 


MISCELLANEOUS AND DEMO PROGRAMS 


FASTFILL 


This is the same area filling program used in PAINT. It 
requires a tablet point to specify the desired value and a 
tablet point to specify the area to be filled. 
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WHPM 


BLPM 
ZPM 
| COLORS 


COLORBARS 
_ ATOD 


PICRUNS 
TYPECOLOR 


TYPECS 


PLVD framei frame2Z 


Global switches: 


/C 
PCM file 


Global switches: 


/C 


VTPM 


HC 
SF 


$P 


White PM. Clears the entire PM to the background value (0} 
and sets the color definition cf the background to white. 


Black PM. 


Resets all PM logic and does BLPM. 


Writes into the PM a pattern of 256 squares representing the 


256 possible values. 
Writes the standard color bar pattern into the PM. 


Causes the output of the real time A/D converter to be 
continuously dumped into the PM whenever the pen is down. 
When the pen is then lifted, the last image stored will be 
retained. To set this up, some switches need to be in the 
right positions. Ask somebody how to do this. If the 
colorspace has been set using SETHUE, a monochrome image 
will result. 7 


This program types out some. statistics (the number of 
runcodes, etc.) within a rectangular area specified via the 
tablet. | 7 | 


Types the value and color definition of a point selected via 
the tablet. Repeats until the pen is touched down on the 
pad. 


Types the entire color space and a count of those values 
currently in use. 


Plays video disk from framel to frame?. 


Repeats. 


P-curve movie. Takes a path (sequence of points} from the 
tablet, then records on the video disk a sequence of frames 
representing the motion of the point array named file through 
that path. 


Takes a continuous path rather than a sequence of 
' discrete points. | 


This is a character generatcr program which writes characters 
into the PM. Various escape characters are used to specify 
font, color, background color, ete: : 

character color . 

defines the font. 

take position from tablet 
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* 
- 


$T use transparent background 
$B background color 


GSMALL | 
BOBSMALL These are versions of Smalltalk which run on the PM system. 
: The turtle (with a colored tail of course} draws into the PM. 
Details are available elsewhere. 


JO file This is the jaggy removal demo program. It sean converts 
line segments specified in file and writes them into the PM 
using monochrome values to remove the quantization effects. 
Best to do SETHUE/W before this. Suitable demo files are: 
WHEEL, UHL (Upper Horizontal Lines}, LHL (Lower 
Horizontal Lines}, GUY.L, MAO.L ("long live Chairman Mao"}. 


JOQ file Same as JO but leaves the quantization effects in. 
FONTEDIT ~ This program allows. the. user to define and edit font 


character outlines via spline curves and write the results out 
on files. Documentation is available from Bob Flegal. 
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ans Er sea Prono eka sa reso 


waters ta 


STRUCTURE COLOR: 


[ VALUE WORD 1 
BLANK BIT 4 : 
C0 BIT 77 IN USE BIT 
Ci BIT 1 | te peste se, 
RED BIT 10 ae | 
BLANK BIT 4 
C2 pits 
C3 BIT 4 
GREEN BIT 10 
BLANK BIT 4 
C4 BIT 4 
C5 BIT 4 
BLUE BIT 10 


MANIFEST [ COLORLEN=4 ] 


STRUCTURE PAFH: | | 7/7 POINT ARRAY FILE HEADER 
b> [ PAFID woRdD 1 // PAF IDENTIFIER 
ia SPARE1 WORD 4 Ak (QOBED at obey 
| | | Cree d FF GSOOKS GY enn 
MODE WORD i een f th 196808 dst, 
SPARES WORD 4 oe i 
WINDOW WORD 1 // SGURCE WINDOW (ase Arbo ) 
/ PARES WORD 1 | CTR | 
COLORTABPTR WORD i 
*NUNVALS WORD 4 
SPARES WORD 4 
SPAREQ WORD 1 
DOs Lintne SPARE 10 WORD - 1. 
peg J SPARE11 WORD 1 
| FORE HOR ROTO PES HOW-PATA-3S-STORED-g 
DATAPTR WORD } 
NUMTABS 9s WORD 4 = beagt we. of Anes me a Aten bene wn they PA 
} SPARE15 WORD 1] 
// WINDOW, coLors (DATA) - belar 
| a FOLLOW (IN THAT” ORDER) 
MANIFEST [ PAFHLEN=16 ] // HEADER LENGTH 
| // UOSGTH OF PAF = PAFHLEN 


fl + peniee + 256*COLORLEN 
f/ ¢ NUMTABS*WINDOWDOWIN .H 


a MANIFEST [ PAFID=#66666 ] // IDENTIFIER 
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STRUCTURE WIN | // WINDOW 
| t VORIG . WORD 
XORIG WORD 

Ho. WORD 

Wi WORE 

YORPF WORD 

KOFF WORD 


coal amniilil anienllllt suen eae ment 


MANIFEST [ WINLEN=6 J 
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